From: Alex Schroeder <alex@gnu.org>
Date: Fri, 20 Jan 2006 21:30:31 +0000 (+0000)
Subject: (rmail-inbox-alist): Doc.
X-Git-Tag: archive/raspbian/1%29.2+1-2+rpi1~1^2~324^2~8790^2~105
X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:///%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:/?a=commitdiff_plain;h=6d3106196f306cb6fd61a99a26dcbd7ebc8fb316;p=emacs.git

(rmail-inbox-alist): Doc.
---

diff --git a/lisp/mail/rmail.el b/lisp/mail/rmail.el
index b1d5cee830e..98865e43621 100644
--- a/lisp/mail/rmail.el
+++ b/lisp/mail/rmail.el
@@ -358,8 +358,14 @@ and the value of the environment variable MAIL overrides it)."
 ;;;###autoload
 (defcustom rmail-inbox-alist nil
   "*Alist of mail files and backup directory names.
-Each element looks like (MAIL-FILE . INBOX-LIST).  Mail files with
-names matching MAIL-FILE will retrieve mail from files in INBOX-LIST."
+Each element has the form (MAIL-FILE INBOX ...).  When running
+rmail on MAIL-FILE, mails in all the INBOX files listed will be
+moved to the MAIL-FILE.  Be sure to fully qualify your MAIL-FILE.
+
+Example setting if procmail delivers all your spam to
+~/Mail/SPAM.in and you read it from the file ~/Mail/SPAM:
+
+\(setq rmail-inbox-alist '((\"~/Mail/SPAM\" \"~/Mail/SPAM.in\")))"
   :type '(alist :key-type file :value-type (repeat file))
   :group 'rmail-retrieve
   :group 'rmail-files)